TableModify
申请修改表
请求地址
POST
http://OmsAddress/app/newoms.php/webservice/business/table/modify?cmd=10003&ip-type=webservicerest&access-token=AccessTokenVal
POST请求参数说明
| 参数名称 | 数据类型 | 说明 | 是否必填字段 | 备注 |
|---|---|---|---|---|
| app_id | 整型 | 修改表所在的业务id | 是 | |
| zone_id | 整型 | 修改表所在的游戏区id | 是 | |
| table_name | 字符串 | 修改表的表名 | 是 | |
| auto_approve | 整型（0或1） | 是否自动审核修改表申请（表所在集群允许自动审核表修改申请） | 否，默认不自动审核 | |
| auto_exec_trans | 整型（0或1） | 是否执行自动审核修改表申请后，生成修改表的事务（表所在的集群允许自动执行修改表事务，auto_approve=1时，auto_exec_trans=1才有效） | 否，默认不自动执行 | |
| attach_id | 数组 | 定义修改后的表结构的文件的id列表，利用接口上传定义表结构的xml/tdr/proto文件操作获取 | 是 | |
| table_params | json | 修改表的相关参数，目前只可修改list表的最大元素个数table_maxnum | 否 | |
| attention_man | 字符串 | 用分号";"分隔关注人，关注人可执行此单据任务，字段最大长度为200 | 否 |
Data参数
使用json格式表示记录相关信息，示例如下：
{
"app_id": 2,
"zone_id": 3,
"table_name": "test_table_generic_modify",
"auto_approve": "",
"auto_exec_trans": "",
"attach_id": [
99
]
}
返回语法
返回参数说明
| 参数名称 | 数据类型 | 说明 | 备注 |
|---|---|---|---|
| apply | json | ret：表示是否申请成功，0表示成功；其他表示失败 msg：表示ret不等于0时的错误信息 info：申请成功的修改表的单据信息，其中uid表示单据id，审核修改表申请时需要此值 | |
| check | json | ret：表示是否审核成功，0表示成功；其他表示失败 msg：表示ret不等于0时的错误信息 info：其中trans_id表示生成的修改表的事务，set_id表示事务所在的集群（表所在的集群） | 当请求参数中指定了自动审核单据（auto_approve=1），返回的信息中才有check字段的信息 |
| exec | json | ret：表示事务是否开始执行，0表示事务开始执行；其他表示失败 msg：表示ret不等于0时的错误信息 | 当请求参数中指定了自动审核单据（auto_approve=1，auto_exec_trans），返回的信息中才有exec字段的信息 |
请求示例
通过 curl 方法发起请求
命令中的参数请参考本页中的“POST请求参数说明”，access-token的获取方法详见：获取access-token
curl -H "Content-type: application/json" -X "POST" -d '{
"app_id": 2,
"zone_id": 3,
"table_name": "test_table_generic_modify",
"auto_approve": "",
"auto_exec_trans": "",
"attach_id": [
99
]
}' http://omsaddress/app/newoms.php/webservice/business/table/modify?cmd=10003&ip-type=webservicerest&access-token=<access-token>
返回示例
成功返回示例
http请求的Status=200，其中返回信息只需要关注ret是否0（0为成功）并拿到info信息中的id （单据id），检查app_id、zone_list、table_name是否对上即可，其他字段无需关注。
{
"apply": {
"ret": 0,
"info": {
"app_id": 2,
"app_name": "t_app",
"set_id": 126,
"zone_list": "3",
"table_name": "test_table_generic_modify",
"table_type": 0,
"estimated_write_load": 0,
"estimated_read_load": 0,
"type": "xml",
"table_maxnum": 0,
"write_time": "2017-03-02 21:34:08",
"apply_type": 3,
"key_avarage_record_size": 1,
"value_avarage_record_size": 1,
"compress": 0,
"active_record_num": "0",
"total_record_num": "3",
"memo": "",
"tdr": "99",
"pcu": 1,
"relationship_chain_interval": 60,
"relationship_chain_count": 1,
"index_count": 1,
"read_index_interval": 60,
"read_index_count": 1,
"read_interval": 60,
"write_interval": 60,
"calc_resource_type": 2,
"user": "tcaplus",
"job_id": "42",
"dm_ratio": 5,
"id": 109
},
"msg": ""
}
}